
    <!DOCTYPE html>
    <html lang="zh-CN">
    <head>
      <meta charset="UTF-8">
      <meta name="viewport" content="width=device-width, initial-scale=1.0">
      <title>Agent CLI Prompt - 学习卡片</title>
      <style>
        body { font-family: sans-serif; background-color: #f0f8ff; color: #333; display: flex; flex-direction: column; align-items: center; padding: 50px 20px; }
        .header h1 { font-size: 32px; }
        .grid-container { display: grid; grid-template-columns: repeat(3, 1fr); gap: 28px; width: 100%; max-width: 1200px; }
        .card-container { perspective: 1200px; cursor: pointer; height: 250px; }
        .card { width: 100%; height: 100%; position: relative; transform-style: preserve-3d; transition: transform 0.7s; border-radius: 16px; box-shadow: 0 4px 16px rgba(0,0,0,0.08); }
        .card-container.flipped .card { transform: rotateY(180deg); }
        .card-face { position: absolute; width: 100%; height: 100%; backface-visibility: hidden; display: flex; flex-direction: column; box-sizing: border-box; border-radius: 16px; background-color: #fff; padding: 24px; }
        .card-back { background-color: #f0fff4; transform: rotateY(180deg); justify-content: space-between; }
        .card-category { font-size: 14px; color: #0052d9; margin-bottom: 8px; font-weight: 500; }
        .card-question { font-size: 20px; font-weight: 500; flex-grow: 1; display: flex; align-items: center; justify-content: center; text-align: center; }
        .card-answer-wrapper { flex-grow: 1; overflow-y: auto; }
        .card-answer { font-size: 15px; line-height: 1.7; }
        .card-footer { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 16px; margin-top: 16px; }
        .card-source { font-size: 13px; color: #8a919f; border-top: 1px solid #f0f0f0; padding-top: 12px; margin-top: 12px; }
      </style>
    </head>
    <body>
      <div class="header">
        <h1>Agent CLI Prompt - 学习卡片</h1>
      </div>
      <div class="grid-container">
        
    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">当AI助手检测到新的目标时，其被规定的四步核心工作流程是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">1. 运行一个简短的发现过程（只读的代码/上下文扫描）。2. 在执行逻辑上分组的工具调用之前，发布一个极其简短的状态更新。3. 执行工具调用。4. 当目标的所有任务完成后，提供一个简要的总结。</div>
          </div>
          <div class="card-source">来源: <flow></div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">机制</div>
          <div class="card-question">关于执行多个工具调用，文档中的“关键指令”是什么？为什么要这样做？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">机制</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">关键指令是：为了最高效率，在执行多个操作时，应尽可能地并发调用所有相关工具，而不是按顺序调用。这是因为并行工具执行可以比顺序调用快3-5倍，从而显著改善用户体验。</div>
          </div>
          <div class="card-source">来源: <maximize_parallel_tool_calls></div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">模式</div>
          <div class="card-question">根据<code>&lt;code_style&gt;</code>部分的命名指南，编写代码时应遵循哪些核心原则？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">模式</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">应避免使用简短的变量/符号名（尤其是1-2个字符的名称）。函数应命名为动词或动词短语，变量应命名为名词或名词短语。变量名应具有意义，描述性强到通常不需要注释，并且优先使用完整的单词而非缩写。</div>
          </div>
          <div class="card-source">来源: <code_style></div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">理论</div>
          <div class="card-question">在与用户的沟通中，“状态更新(status update)”和“总结(summary)”的核心区别是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">理论</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">“状态更新”是在任务执行过程中，关于刚刚发生了什么、即将要做什么的简短进展说明。而“总结”是在AI的回合结束时提供，用以高层次地概括所有已做的变更及其影响。</div>
          </div>
          <div class="card-source">来源: <status_update_spec> 和 <summary_spec></div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">当AI助手需要探索代码库时，其主要的探索工具是什么？使用该工具时必须遵循的策略是什么？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">主要的探索工具是Grep搜索。必须遵循的策略是：并行运行多个具有不同模式和变体的Grep搜索，从广泛的查询开始，直到确信没有遗漏任何重要内容，然后再缩小搜索范围并读取最可能相关的文件。</div>
          </div>
          <div class="card-source">来源: <context_understanding></div>
        </div>
      </div>
    </div>

    <div class="card-container" onclick="this.classList.toggle('flipped');">
      <div class="card">
        <div class="card-face card-front">
          <div class="card-category">技术</div>
          <div class="card-question">在使用 `ApplyPatch` 工具编辑文件时，如果该文件在近期未被读取，必须采取什么预防措施？</div>
          <div class="card-footer">点击卡片查看答案</div>
        </div>
        <div class="card-face card-back">
          <div class="card-category">技术</div>
          <div class="card-answer-wrapper">
            <div class="card-answer">如果要对一个在最近五条消息内没有使用 `Read` 工具读取过的文件调用 `ApplyPatch`，那么在尝试应用补丁之前，必须再次使用 `Read` 工具读取该文件以重新确认其内容。这是为了防止因文件内容变化而导致应用错误的上下文，从而产生高昂的代价。</div>
          </div>
          <div class="card-source">来源: <making_code_changes></div>
        </div>
      </div>
    </div>

      </div>
    </body>
    </html>
